.. _cemStCount_Set:

cemStCount_Set
==============
--------------


SYNOPSIS
--------


.. code-block:: none

  VT_I4 cemStCount_Set(
    VT_I4 Axis,
    VT_I4 Target,
    VT_I4 Count
  )



DESCRIPTION
-----------


- 해당 축의 지정한 카운터 값을 새로이 설정합니다. 단, 이때 지정하는 카운터 값의 단위는 펄스 수(PPS)입니다. 이 함수는 카운터의 값을 지정하는 매개변수의 단위가 펄스 수라는 것 을 제외하고는 cemStPosition_Set 함수와 동일합니다.



PARAMETER
---------


- Axis : 축 번호. 통합 축으로 관리되는 축 번호를 의미하며, 상수 값으로 0 (Zero Based) 이상,. (최대 통합 축 개수 - 1) 이하의 값을 축 번호로 설정할 수 있습니다. 

- Target : 설정할 카운터 번호. cemStCount_Set 함수의 인자이며, 다음의 4 가지 값 중의 하나이. 어야 합니다. 

+-----------------+--------------------------------------------------------------------------------+
| Value           | Meaning                                                                        |
+=================+================================================================================+
| 0 (cemCNT_COMM) | Command Counter.                                                               |
+-----------------+--------------------------------------------------------------------------------+
| 1 (cemCNT_FEED) | Feedback Counter                                                               |
+-----------------+--------------------------------------------------------------------------------+
| 2 (cemCNT_DEV)  | Deviation Counter : Command 와 Feedback 카운터의 편차 카운터.                  |
+-----------------+--------------------------------------------------------------------------------+
| 3 (cemCNT_GEN)  | General Counter : 사용자의 정의에 따라 여러 가지 용도로 사용될 수 있는 카운터. |
+-----------------+--------------------------------------------------------------------------------+


- Count :  지정한 값으로 대상 카운터의 값을 설정합니다. 




RETURN VALUE
------------


+----------------+-----------+
| Value          | Meaning   |
+================+===========+
| 음수           | 수행 실패 |
+----------------+-----------+
| 0 (ceERR_NONE) | 수행 성공 |
+----------------+-----------+

Example
-------
.. code-block:: cpp
 :linenos:


  C/C++
  #include “ceSDK.h”
  #include “ceSDKDef.h”
 void OnSetCount ()
 {
  long nCommCount; // Command Count
  long nFeedCount; // Feedback Count
  /* Command, Feedback 카운트 값을 확인한 후, ‘0’ 으로 초기화 합니다. */
  if ( cemStCount_Get ( cemX1, cemCNT_COMM, &nCommCount ) == ceERR_NONE )
  {
   if ( nCommCount != 0 )
    {
    // Command 카운트를 0 으로 설정합니다.
    cemStCount_Set ( cemX1, cemCNT_COMM, 0 );
    }
  }
  if ( cemStCount_Get ( cemX1, cemCNT_FEED, &nFeedCount ) == ceERR_NONE )
  {
   if ( nFeedCount != 0 )
    {
    // Feedback 카운트를 0 으로 설정합니다.
    cemStCount_Set ( cemX1, cemCNT_FEED, 0 );
    }
  }
 }